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Problem Determination APIs 


The problem determination APIs are: 
e Qp0zDumpQ( (Dump formatted storage trace data) dumps the user storage specified by area to the 
user trace. 
e@ Qp0zDumpStack() (Dump formatted stack trace data) dumps a formatted representation of the call 
stack of the calling thread to the user trace. 


e@ Qp0zDumpTargetStack() (Dump formatted stack trace data of the target thread) dumps a formatted 
representation of the call stack of the target thread to the user trace. 


e Qp0zLprintfQ (Print formatted job log data) prints user data specified by format-string as an 
information message type to the job log. 


e@ Qp0zUprintfQ (Print formatted user trace data) prints user data specified by the format-string 
parameter to the user trace. 


Note: These functions use header (include) files from the library QS YSINC, which is optionally installable. 
Make sure QSYSINC is installed on your system before using any of the functions. See Header Files for 


UNIX-Type Functions for the file and member name of each header file. 


The problem determination APIs are intended to be used as an aid in debugging exception or error 
conditions in application programs. These functions should not be used in performance critical code. 


These functions can be used during application development, as well as after the application is made 
available, as debug mechanisms. For example, one of the following methods could be used: 


e Use acompile option that activates the problem determination functions during application 
development. When the application is ready to be made available, recompile to deactivate the 
functions. 


e Design a method to (quickly) check and see whether application problem determination is desired, 
as well as an external method to activate application problem determination. Then, use the problem 
determination functions in such a manner as to check (at run time) whether or not the functions 
should be called. 


Some of the problem determination functions dump or print to the user trace. The user trace is a permanent 
user space object named QPOZ<jobnumber> in the QUSRSYS library. The user trace is created the first 
time any thread in a job writes trace output. The following CL commands can be used to manipulate the 
user trace properties and objects: 


e Change User Trace (CHGUSRTRC) can be used to change the characteristics of the user trace. 


e Dump User Trace (DMPUSRTRC) can be used to dump trace records to a file or to standard 
output. 


e Delete User Trace (DLTUSRTRC) can be used to delete the user trace objects. 


For those problem determination functions that use the user trace, the following should be considered: 


e The functions require no authority to the user trace object. See CL commands CHGUSRTRC, 
DMPUSRTRC, and DLTUSRTRC for the authority required to administer, display, or modify 
tracing information using the CL commands. 


e No locks are held on the user trace between calls to the tracing functions. The user trace can be 
deleted while in use. The next function that produces trace output will create the user trace again. 


e If another job on the system has the same job number as an existing user trace, the existing trace 
data is cleared, and the trace data from the new job replaces it. 
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Qp0zDump()--Dump Formatted Storage Trace Data 


Syntax 


#include <qpOztrc.h> 
void QpOzDump(const char *label, 


void *area, 
int len); 


Service Program Name: QPOZCPA 


Default Public Authority: *USE 


Threadsafe: Yes 


The Qp0zDump() function dumps the user storage specified by area to the user trace. The user-provided storage is 
formatted for viewing in hexadecimal representation for up to Jen number of bytes. The formatted storage is labeled 
with the text string specified by label. 


If any input parameters are not valid, or an incorrect or error condition is detected, the Qp0zDump() function 
returns immediately and no error is indicated. 


An application should not use the tracing function in performance critical code. These functions are intended for 
debugging exception or error conditions. The user trace is a permanent user space object named 
QPOZ<jobnumber> in the QUSRSYS library. The user trace is created the first time any thread in a job writes 
trace output. See the Change User Trace (CHGUSRTRC), Dump User Trace (DMPUSRTRC) and Delete User 
Trace (DLTUSRTRC) CL commands for information about manipulating the user trace properties and objects. 


Parameters 


label 
(Input) A pointer to a string that is used to label the storage dump. 


area 

(Input) A pointer to storage area that is to be formatted and dumped to the user trace. 
len 

(Input) The number of bytes of storage to be formatted in the user trace. 
Authorities 


None. 


Return Value 


None. 


Error Conditions 


If Qp0zDumpd( is not successful, the function returns immediately and no error is indicated. 


Usage Notes 


1. No locks are held on the user trace between calls to the tracing functions. The user trace can be deleted 
while in use. The next function that produces trace output will create the user trace again. 


2. If another job on the system has the same job number as an existing user trace, the existing trace data is 
cleared, and the trace data from the new job replaces it. 


3. As the format of the user trace records can change, only the following CL commands can be used to 
manipulate the user trace properties and objects: 


o Change User Trace (CHGUSRTRC) can be used to change the characteristics of the user trace. 


o Dump User Trace (DMPUSRTRC) can be used to dump trace records to a file or to standard 
output. 


o Delete User Trace (DLTUSRTRC) can be used to delete the user trace objects. 


Related Information 


e@ Qp0zDumpStack()--Dump Formatted Stack Trace Data 


e Qp0zDumpTargetStack()--Dump Formatted Stack Trace Data of the Target Thread 


e Qp0zLprintf(Q--Print Formatted Job Log Data 


@ Qp0zUprintf()--Print Formatted User Trace Data 


Example 
The following example uses Qp0zDump() and Qp0zUprintfQ) functions to produce trace output. 


#define ~MULTI_THREADED 
#include <pthread.h> 
#include <stdio.h> 
#include <stdlib.h> 
#include <unistd.h> 
#include <qp0ztrc.h> 


#define THREADDATAMAX 128 


void *theThread(void *parm) 
{ 


char *myData = parm; 


printf("Entered the %s thread\n", myData); 
QpOzUprintf ("Tracing in the %s thread\n", myData); 
QpOzDump ("The Data", myData, THREADDATAMAX) ; 

free (myData) ; 

return NULL; 


int main(int argc, char **argv) 


{ 


pthread_t thread, thread2; 
int rc=0; 

char *threadData; 
printf("Enter Testcase - %s\n", argv[0]); 


QpOzUprintf ("Tracing Testcase Entry\n"); 


printf("Create two threads\n"); 
QpOzUprintf ("Tracing creation of two threads\n"); 


threadData = (char *)malloc (THREADDATAMAX) ; 

memset (threadData, 'Z', THREADDATAMAX) ; 

sprintf (threadData, "50%% Cotton, 50%% Polyester"); 

re = pthread_create(&thread, NULL, theThread, threadData); 

if (re) { 
printf("Failed to create a %s thread\n", threadData) ; 
exit (EXIT_FAILURE) ; 

} 


threadData = (char *)malloc (THREADDATAMAX) ; 

memset (threadData, 'Q', THREADDATAMAX) ; 

sprintf (threadData, "Lacquered Camel Hair"); 

re = pthread_create(&thread2, NULL, theThread, threadData); 

if (re) { 
printf("Failed to create a %s thread\n", threadData) ; 
exit (EXIT_FAILURE) ; 

} 


printf("Wait for threads to complete\n"); 
re = pthread_join(thread, NULL); 
if (re) { printf("Failed pthread_join() 1\n"); exit (EXIT_FAILURE); } 


re = pthread_join(thread2, NULL); 
if (re) { printf("Failed pthread_join() 2\n"); exit (EXIT_FAILURE); } 


printf("Testcase complete\n"); 
QpOzUprintf ("Tracing completion of the testcase rce=%d\n", rc); 
return 0; 


Trace Output: 


This trace output was generated after the test case was run by using the CL command DMPUSRTRC 
JOB(100464/USER/TPZDUMP0) OUTPUT(*STDOUT). The above example program ran as job 


100464/USER/TPZDUMPO. 


Note the following in the trace output: 


1. Each trace record is indented by several spaces to aid in readability. Trace records from different threads 
have different indentation levels. 


. Each trace record is identified by the hexadecimal thread ID, a colon, and a timestamp. The timestamp can 


be used to aid in debugging of waiting or looping threads. For example, the third trace record shown below 
(the Tracing Testcase Entry trace point) was created by thread 0x13, and occurred 0.870960 seconds after 
the last full date and time label. This means that the trace record was created on 5 January 1998 at 
14:08:28.870960. A full date and time label is placed between those trace points that occur during different 


whole seconds. 


User Trace Dump for job 100464/USER/TPZDUMPO. 


times. 


—--— 01/05/1998 14:08:28 --- 


00000013:870960 Tracing Testcase Entry 
00000013:871720 Tracing creation of two threads 


00000014:879904 
00000014:880256 
00000014:880968 
Cotton, 50% * 
00000014:881680 
*Polyester.ZZZ2Z222* 
00000014:882392 
* ZZLZLZLZLZLZZLZ2ZLZ2Z2222* 
00000014:883096 
* ZZLZLZLZLZLZLZLZ2ZLZ2Z2222* 
00000014:883808 
*ZLZLZLZLZLZLZLZLZ2ZLZ2Z2222* 
00000014:884512 
* ZZLZLZLZLZLZLZLZ2Z2Z2Z2222* 
00000014:885224 
* ZZLZLZLZLZLZ2Z2Z2Z2Z2Z2222* 
00000015:887872 
00000015:888216 
00000015:888952 
94859340 
00000015:889680 
D8D8D8D8 
00000015:890416 
D8D8D8D8 
00000015:891152 
D8D8D8D8 
00000015:891888 
D8D8D8D8 
00000015:892624 


*50% 


15:893352 


15:894088 


Tracing in the 50% Cotton, 


CO6E80F4DF: 0 
CO6E80F4DF: 


CO6E80F4DF: 
C6O6E80F4DF: 
CO6E80F4DF: 
C6O6E80F4DF: 
CO6E80F4DF: 
C6O6E80F4DF: 
Tracing in 


C6O6E80F4DF: 
C66E80F4DF 


*Lacquered Camel * 


C66E80F4DF 


*Hair .QQ000000000* 
C66E80F4DF: 
*QQ00000000000000* 
C66E80F4DF: 
*QQ00000000000000* 
C66E80F4DF: 
*QQ00000000000000* 
C66E80F4DF: 
*QQ00000000000000* 
C66E80F4DF: 
*QQ00000000000000* 
C66E80F4DF: 
*QQ00000000000000* 


O1F60 L:0080 The 
OO1F60 F5F06C40 
OO1F70 D79693A8 
OO1F80 EQEIEQIE9 
OO1F90 EQEQIEQIE9 
OO1FAQ EQEQIEQSE9 
OO1FBO E9EQIE9E9 
OO1FCO EQEQIE9E9 


Size: 


Data 
C39 6A3A3 


85A2A385 


E9E9EQ9EY 


E9E9EYEY 


E9E9EQ9EY 


E9E9EQYEY 


E9E9EQYEY 


300K, Wrapped 0 


50% Polyester thread 


96956B40 


9900E9E9 


E9EIEQIE9 


E9EIEQIE9 


E9EIEQIE9 


E9EIEQIE9 


E9EIEQIE9 


the Lacquered Camel Hair thread 


002000 L:0080 The 


2002000 D3818398 
2002010 C8818999 
002020 D8D8D8D8 
002030 D8D8D8D8 
002040 D8D8D8D8 
002050 D8D8D8D8 
002060 D8D8D8D8 
002070 D8D8D8D8 


Data 
A4859985 


OOD8D8D8 


D8D8D8D8 


D8D8D8D8 


D8D8D8D8 


D8D8D8D8 


D8D8D8D8 


D8D8D8D8 


8440C381 


D8D8D8D8 


D8D8D8D8 


D8D8D8D8 


D8D8D8D8 


D8D8D8D8 


D8D8D8D8 


D8D8D8D8 


F5F06C40 


E9EIEQIE9 


E9EIEQIE9 


E9EIEQIE9 


E9EIEQIE9 


E9EIEQIE9 


BIE IEQIE9 


00000014:896168 C66E80F4DF:001FD0 E9E9SEIEY EIEQIEIEI EYEQIEIEI EQIEQEIEY 
* 7 ZZ2ZZ2Z22Z222222224* 

00000013:898832 Tracing completion of the testcase rc=0 
Press ENTER to end terminal session. 


API introduced: V4R3 
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Qp0zDumpStack()--Dump Formatted Stack Trace 
Data 


#include <qpOztrc.h> 


void QpOzDumpStack(const char *label); 


Service Program Name: QPOZCPA 


Default Public Authority: *USE 


Threadsafe: Yes 


The Qp0zDumpStack() function dumps a formatted representation of the call stack of the calling thread to the user 
trace. The formatted call stack is labeled with the text string specified by /abel. The formatted call stack shows the 
library, program, module, and procedure information associated with each frame on the call stack. 


The formatted dump of the current call stack shows the oldest entries first, followed by newer entries. 


The following example is a call stack dump if the Qp0zDumpStack() function is used to dump the stack of the 
current thread. The label Thread dumping my own stack was inserted by the application program using the label 
parameter. 


The thread start routine in this example is threadfunc() in program or service program ATESTS that resides in 
library QPOWTEST. The threadfunc() function (at statement 2) has called the function foo(. The function fooQ) 
(at statement 1), in turn has called bar(). The function bar() (at statement 1), has dumped the current call stack due 
to some application-specific error condition. 


Thread dumping my own stack 


Library / Program Module Stmt Procedure 

QOSYS / QLESPI QLECRTTH 7 : LE_Create_Thread2 
Qsys / QPOWPTHR QPOWPTHR 974 : pthread_create_part2 
QPOWTEST / ATEST5 ATEST5 2 : threadfunc 

QPOWTEST / ATEST5 ATEST5 ok : £oo 

QPOWTEST / ATEST5 ATEST5 i : bar 

QSYS / QPOZCPA QPOZUDBG 5 Qp0zDumpStack 

OSYS / QPOZSCPA QPOZSCPA 199 Qp0zSUDumpStack 

QsyYs / QPOZSCPA QPOZSCPA 210 QpO0zSUDumpTargetStack 


An application should not use the tracing function in performance critical code. These functions are intended for 
debugging exception or error conditions. The user trace is a permanent user space object named 
QPOZ<jobnumber> in the QUSRSYS library. The user trace is created the first time any thread in a job writes 
trace output. See the Change User Trace (CHGUSRTRC), Dump User Trace (DMPUSRTRC) and Delete User 
Trace (DLTUSRTRC) CL commands for information about manipulating the user trace properties and objects. 


Parameters 


label 

(Input) A pointer to a string that is used to label the stack dump. 
Authorities 
None. 


Return Value 


None. 


Error Conditions 


If Qp0zDumpStack() is not successful, the function returns immediately and no error is indicated. 


Usage Notes 


1. No locks are held on the user trace between calls to the tracing functions. The user trace can be deleted 
while in use. The next function that produces trace output will create the user trace again. 


2. If another job on the system has the same job number as an existing user trace, the existing trace data is 
cleared, and the trace data from the new job replaces it. 


3. If the calling thread has more than 128 call stack entries, Qp0zDumpStack() returns after dumping the 
first 128 entries of the call stack. 


4. As the format of the user trace records can change, only the following CL commands can be used to 
manipulate the user trace properties and objects: 


o Change User Trace (CHGUSRTRC) can be used to change the characteristics of the user trace. 


oO Dump User Trace (DMPUSRTRC) can be used to dump trace records to a file or to standard 
output. 


o Delete User Trace (DLTUSRTRC) can be used to delete the user trace objects. 


Related Information 


e Qp0zDumpQ(--Dump Formatted Storage Trace Data 


@ Qp0zDumpTargetStack()--Dump Formatted Stack Trace Data of the Target Thread 


e Qp0zLprintfQ--Print Formatted Job Log Data 


e Qp0zUprintfO--Print Formatted User Trace Data 


Example 
The following example uses Qp0zDumpStack() and Qp0zUprintfQ) functions to produce trace output. 


#define ~MULTI_THREADED 
#include <pthread.h> 
#include <stdio.h> 
#include <stdlib.h> 
#include <unistd.h> 
#include <qp0ztrc.h> 


#define THREADDATAMAX 128 


void foo(char *string); 
void bar(char *string); 


void *theThread(void *parm) 


{ 


char *myData = parm; 


printf("Entered the %s thread\n", myData); 
foo (myData) ; 
free (myData) ; 
return NULL; 
} 


void foo(char *string) 


{ 
bar (string); 


} 


void bar(char *string) 

{ 
QpOzUprintf ("function bar(): Hit an error condition! \n"); 
QpOzDumpStack (string); 

} 


int main(int argc, char **argv) 


{ 


pthread_t thread, thread2; 
int rc=0; 

char *threadData; 
printf("Enter Testcase - %s\n", argv[0]); 


QpOzUprintf ("Tracing Testcase Entry\n"); 


printf("Create two threads\n"); 
QpOzUprintf ("Tracing creation of two threads\n"); 


threadData = (char *)malloc (THREADDATAMAX) ; 
sprintf (threadData, "50%% Cotton, 50%% Polyester"); 
re = pthread_create(&thread, NULL, theThread, threadData) ; 
if (rc) { 
printf("Failed to create a %s thread\n", threadData) ; 


exit (EXIT_FAILURE) ; 
} 


threadData = (char *)malloc (THREADDATAMAX) ; 
sprintf (threadData, "Lacquered Camel Hair"); 
re = pthread_create(&thread2, NULL, theThread, threadData) ; 
if (rc) { 
printf("Failed to create a %s thread\n", threadData) ; 
exit (EXIT_FAILURE) ; 
} 


printf("Wait for threads to complete\n"); 
re = pthread_join(thread, NULL); 
if (re) { printf("Failed pthread_join() 1\n"); exit (EXIT_FAILURE); } 


re = pthread_join(thread2, NULL); 
if (re) { printf("Failed pthread_join() 2\n"); exit (EXIT_FAILURE); } 


printf ("Testcase complete\n"); 
QpOzUprintf ("Tracing completion of the testcase rce=%d\n", rc); 
return 0; 


Trace Output: 


This trace output was generated after the test case was run by using the CL command DMPUSRTRC 
JOB(100465/USER/TPZSTK0) OUTPUT(*STDOUT). The above example program ran as job 
100465/USER/TPZSTKO. 


Note the following in the trace output: 


1. Each trace record is indented by several spaces to aid in readability. Trace records from different threads 
have different indentation levels. 


2. Each trace record is identified by the hexadecimal thread ID, a colon, and a timestamp. The timestamp can 
be used to aid in debugging of waiting or looping threads. For example, the third trace record shown 
below, (the Tracing Testcase Entry trace point) was created by thread 0x16, and occurred 0.841456 
seconds after the last full date and time label. This means that the trace record was created on 5 January 
1998 at 16:32:23.841456. A full date and time label is placed between those trace points that occur during 
different whole seconds. 


User Trace Dump for job 100465/USER/TPZSTKO. Size: 300K, Wrapped 0 times. 
-—-- 01/05/1998 16:32:23 -—-- 
00000016:841456 Tracing Testcase Entry 
00000016:842176 Tracing creation of two threads 
7:850328 function bar(): Hit an error condition! 
00000017:850552 Stack Dump For Current Thread 
7:850752 Stack: 50% Cotton, 50% Polyester 
00000018:853288 function bar(): Hit an error condition! 
00000018:853512 Stack Dump For Current Thread 
00000018:853712 Stack: Lacquered Camel Hair 


00000018:888752 Stack: Library / Program Module Stmt 
Procedure 
00000017:889400 Stack: Library / Program Module Stmt 


Procedure 


00000017:904848 Stack: QSYS QLESPTI QLECRTTH 774 
LE_Create_Thread2__ FP12crtth_parm_t 
00000017:905088 Stack: QSYS QPOWPTHR QPOWPTHR 1004 
pthread_create_part2 
00000017:905312 Stack: QPOWTEST TPZSTKO TPZSTKO 2 
theThread 
00000017:905528 Stack:  QPOWTEST TPZSTKO TPZSTKO 1 
foo 
00000017:905744 Stack: QPOWTEST TPZSTKO TPZSTKO 2 
bar 
00000017:905960 Stack: QSYS QPOZCPA QPOZUDBG 85 
QpOzDumpStack 
00000017:906184 Stack: QSYS QPOZSCPA QPOZSCPA 274 
QpOzSUDumpStack 
00000017:906408 Stack: QSYS QPOZSCPA QPOZSCPA 285 
QpOzSUDumpTargetStack 
00000017:906536 Stack: Completed 
00000018:908504 Stack: OSYS / QLESPI QLECRTTH 774 
LE_Create_Thread2__ FP12crtth_parm_t 
00000018:908744 Stack: OSYS / QPOWPTHR QPOWPTHR 1004 
pthread_create_part2 
00000018:908960 Stack: QPOWTEST / TPZSTKO TPZSTKO 2 
theThread 
00000018:909168 Stack: QPOWTEST / TPZSTKO TPZSTKO 1. foo 
00000018:909384 Stack: QPOWTEST / TPZSTKO TPZSTKO 2 bar 
00000018:909592 Stack: QSYS / QPOZCPA QP0ZUDBG 85 
QpOzDumpStack 
00000018:909816 Stack: QSYS / QPOZSCPA QPOZSCPA 274 
QpOzSUDumpStack 
00000018:910032 Stack: QSYS / QPOZSCPA QPOZSCPA 285 
QpOzSUDumpTargetStack 
00000018:910168 Stack: Completed 


00000016:912792 Tracing completion of the testcase rc=0 
Press ENTER to end terminal session. 


API introduced: V4R3 
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Qp0zDumpTargetStack()--Dump Formatted Stack 
Trace Data of the Target Thread 


Syntax 


#include <qpOztrc.h> 


int QpOzDumpTargetStack (int handle, 
const char *label); 


Service Program Name: QPOZCPA 


Default Public Authority: *USE 


Threadsafe: Conditional; see Usage Notes. 


The Qp0zDumpTargetStack() function dumps a formatted representation of the call stack of the target thread to 
the user trace. The target thread is specified by handle, which can be filled in using the pthread_t structure. The 
formatted call stack is labeled with the text string specified by label. The formatted call stack shows the library, 
program, module, and procedure information associated with each frame on the call stack at the time the function 
was called. 


The formatted dump of the target call stack shows the oldest entries first, followed by newer entries. 


For consistent results, ensure that the target thread specified in the handle parameter is blocked or waiting for some 
resource and not actively running. 


If a target thread that is actively running is specified, the stack trace information may be inconsistent. 

An application should not use the tracing function in performance critical code. These functions are intended for 
debugging exception or error conditions. The user trace is a permanent user space object named 
QPOZ<jobnumber> in the QUSRSYS library. The user trace is created the first time any thread in a job writes 


trace output. See the Change User Trace (CHGUSRTRC), Dump User Trace (DMPUSRTRC) and Delete User 
Trace (DLTUSRTRC) CL commands for information about manipulating the user trace properties and objects. 


Parameters 


handle 
(Input) A handle to the target thread. 


label 
(Input) A pointer to a string that is used to label the stack dump. 


Authorities 


None. 


Return Value 


0 


value 


Qp0zDumpTargetStack() was successful. 


Qp0zDumpTargetStack() was not successful. The value returned is an errno indicating the failure. 


Error Conditions 


If Qp0zDumpTargetStack() is not successful, the return value usually indicates one of the following errors. Under 
some conditions, the return value could indicate an error other than those listed here. 


[EFAULT] The address used for an argument is not correct. 


In attempting to use an argument in a call, the system detected an address that is not valid. 


While attempting to access a parameter passed to this function, the system detected an address that 
is not valid. 


[ESRCH] No item could be found that matches the specified value. 


Usage Notes 


1. 


No locks are held on the user trace between calls to the tracing functions. The user trace can be deleted 
while in use. The next function that produces trace output will create the user trace again. 


. If another job on the system has the same job number as an existing user trace, the existing trace data is 


cleared, and the trace data from the new job replaces it. 


. The Qp0zDumpTargetStack() can only safely be used against a thread that is stopped or waiting for some 


activity to occur. If Qp0zDumpTargetStack() is used with a thread that is actively running, the output 
stack trace may show an inconsistent view of the call stack. 


. If the target thread has more than 128 call stack entries, Qp0zDumpTargetStack() returns after dumping 


the first 128 entries of the call stack. 


. As the format of the user trace records can change, only the following CL commands can be used to 


manipulate the user trace properties and objects: 
o Change User Trace (CHGUSRTRC) can be used to change the characteristics of the user trace. 


oO Dump User Trace (DMPUSRTRC) can be used to dump trace records to a file or to standard 
output. 


oO Delete User Trace (DLTUSRTRC) can be used to delete the user trace objects. 


Related Information 


e@ Qp0zDump(Q--Dump Formatted Storage Trace Data 


e@ Qp0zDumpStack()--Dump Formatted Stack Trace Data 


e Qp0zLprintfQ--Print Formatted Job Log Data 


e Qp0zUprintf()--Print Formatted User Trace Data 


Example 
The following example uses Qp0zDumpTargetStack() and Qp0zUprintf() functions to produce trace output. 


#define ~MULTI_ THREADED 
#include <pthread.h> 
#include <milib.h> 
#include <stdio.h> 
#include <errno.h> 
#include <unistd.h> 
#include <qpOztrc.h> 


void *threadfunc(void *); 


int main(int argc, char **argv) 
{ 
int rc=0; 
pthread_t thread; 


Qp0zUprintf ("Entering Testcase\n"); 
re = pthread_create(&thread, NULL, threadfunc, NULL); 
sleep(2); /* Let the thread block */ 


/* If the other thread ends or is actively running (that is * / 
/* changing the call stack, you may get meaningless results in the*/ 
/* stack dump for the target thread.) ay, 


QpOzDumpTargetStack (thread. reservedHandle, 

"Dumping target thread's stack\n"); 
QpOzUprintf ("Exit with return code of 0O\n"); 
return 0; 


void foo(void); 

void bar(void); 

void *threadfunc(void *parm) 

{ 
QpO0zUprintf ("Inside secondary thread\n") ; 
foo(); 
return NULL; 

} 


void foo(void) 
{ 
bar (); 


} 


void bar (void) 

{ 
QpOzDumpStack ("Thread dumping my own stack\n"); 
sleep(10); /* Ensure the thread is blocked */ 

} 


Trace Output: 


This trace output was generated after the test case was run by using the CL command DMPUSRTRC 
JOB(107141/USER/TPZTSTK0) OUTPUT(*STDOUT). The above example program ran as job 
107141/USER/TPZTSTKO. 


Note the following in the trace output: 


1. Each trace record is indented by several spaces to aid in readability. Trace records from different threads 
have different indentation levels. 


2. Each trace record is identified by the hexadecimal thread ID, a colon, and a timestamp. The timestamp can 
be used to aid in debugging of waiting or looping threads. For example, the third trace record shown 
below, (the Entering Testcase trace point) was created by thread 0x36, and occurred 0.595584 seconds 
after the last full date and time label. This means that the trace record was created on 23 January 1998 at 
12:38:10.595584. A full date and time label is placed between those trace points that occur during different 
whole seconds. 


User Trace Dump for job 107141/USER/TPZTSTKO. Size: 300K, Wrapped 0O times. 
—--— 01/23/1998 12:38:10 -—-- 
00000036:595584 Entering Testcase 
00000037:598832 Inside secondary thread 
00000037:599024 Stack Dump For Current Thread 
00000037:599200 Stack: Thread dumping my own stack 


00000037:695440 Stack: Library / Program Module Stmt 
Procedure 

00000037:752984 Stack: QSYS / QLESPI QLECRTTH 774 
LE_Create_Thread2__ FP12crtth_parm_t 

00000037:805664 Stack: OQSYS / QPOWPTHR QPOWPTHR 1006 
pthread_create_part2 

00000037:805888 Stack: QPOWTEST / TPZTSTKO TPZTSTKO 2 
threadfunc 

00000037:806088 Stack: QPOWTEST / TPZTSTKO TPZTSTKO 1 
foo 

00000037:806288 Stack: QPOWTEST / TPZTSTKO TPZTSTKO 1 
bar 

00000037:806496 Stack: QSYS / QPOZCPA QPOZUDBG 85 
QpO0zDumpStack 

00000037:848280 Stack: QSYS / QPOZSCPA QPOZSCPA 274 
QpOzSUDumpStack 

00000037:848504 Stack: QSYS / QPOZSCPA QPOZSCPA 285 


QpOzSUDumpTargetStack 
00000037:848616 Stack: Completed 
—-- 01/23/1998 12:38:12 -—-- 
00000036:628272 Stack Dump For Target Thread: Handle 7 (0x00000007) 
00000036:628464 Stack: Dumping target thread's stack 


00000036:651608 
Procedure 
00000036:651872 


LE_Create_Thread2__ FP12crtth_parm_t 


00000036: 652088 
pthread_create_part2 

00000036: 652304 
threadfunc 

00000036:652512 


foo 

00000036:652712 
bar 

00000036:677456 
sleep 


00000036:700096 
qp0swait__FP13qp0ssigwait_t 
00000036:700216 
00000036:700408 Exit with return code of 0 
Press ENTER to end terminal session. 


Stack: Library 
Stack: QSYS 
Stack: QSYS 
Stack: QPOWTEST 
Stack: QPOWTEST 
Stack: QPOWTEST 
Stack: QSYS 
Stack: QSYS 
Stack: Completed 


Program 
QLESPI 
QPOWPTHR 
TPZTSTKO 


TPZTSTKO 


TPZTSTKO 
QPOSSRV1 


QPOSSRV2 


Module 

QLECRTTH 
QPOWPTHR 
TPZTSTKO 
TPZTSTKO 


TPZTSTKO 


QPOSLIB 


QPOSWAIT 


Stmt 
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Qp0zLprintf()--Print Formatted Job Log Data 


Syntax 


#include <qpOztrc.h> 


int QpOzLprintf(char *format-string, ...); 


Service Program Name: QPOZCPA 


Default Public Authority: *USE 


Threadsafe: Yes 


The Qp0zLprintf() function prints user data specified by format-string as an information message type to the job 
log. 


If a second parameter, argument-list, is provided, Qp0zLprintfQ converts each entry in the argument-list and 
writes the entry to the job log according to the corresponding format specification in format-string. If there are 
more entries in argument-list than format specifications in format-string, the extra argument-list entries are 
evaluated and then ignored. If there are less entries in argument-list than format specifications in format-string, the 
job log output for those entries is undefined, and the Qp0zLprintf() function may return an error. 


The data printed by Qp0zLprintf() is buffered one line at a time, and a new message in the job log is forced every 
512 characters if a new line (\n) is not detected in the data before that time. The buffer used by Qp0zLprintf() is 
not physically written when the application ends. To ensure messages are written to the job log, always use a new 
line (\n) at the end of each format-string. 


An application should not use the tracing function in performance critical code. These functions are intended for 
debugging exceptions or error conditions. 


Parameters 


format-string 


(Input) The format string representing the format of the data to be printed. See the printf() function in ILE 


< 
C/C++ for iSeries Run-Time Library Functions for a description of valid format strings. 


... (argument-list) 


(Input) An optional list of arguments that contain entries to be formatted and printed to the job log. 


Authorities 


None. 


Return Value 


value Qp0zLprintfQ was successful. The value returned is the number of characters successfully printed. 


-1 Qp0zLprintf() was not successful. The errno variable is set to indicate the error. 


Error Conditions 


If Qp0zLprintf() is not successful, errno usually indicates one of the following errors. Under some conditions, 
ermo could indicate an error other than that listed here. 


[EINVAL] An invalid parameter was found. 
A parameter passed to this function is not valid. 
An invalid format-string or argument-list was specified. 
[EFAULT] The address used for an argument is not correct. 
In attempting to use an argument in a call, the system detected an address that is not valid. 


While attempting to access a parameter passed to this function, the system detected an address that 
is not valid. 


Usage Notes 


None. 


Related Information 


e@ Qp0zDumpQ--Dump Formatted Storage Trace Data 


@ Qp0zDumpStack()--Dump Formatted Stack Trace Data 


e Qp0zDumpTargetStack()--Dump Formatted Stack Trace Data of the Target Thread 


e Qp0zUprintfQ--Print Formatted User Trace Data 


Example 
The following example uses Qp0zLprintfQ to produce output in the job log. 


#define _~MULTI_ THREADED 
#include <pthread.h> 
#include <stdio.h> 
#include <stdlib.h> 


#include <unistd.h> 
#include <qp0ztrc.h> 


#define THREADDATAMAX 128 


void *theThread(void *parm) 
{ 


char *myData = parm; 


QpOzLprintf("%.8x %.8x: Entered the %s thread\n", 
pthread_getthreadid_np(), myData); 
free (myData) ; 
return NULL; 
} 


int main(int argc, char **argv) 


{ 


pthread_t thread, thread2; 
int rc=0; 
char *threadData; 


printf("Create two threads\n"); 
QpOzUprintf ("Tracing creation of two threads\n"); 


threadData = (char *)malloc (THREADDATAMAX) ; 
sprintf (threadData, "50%% Cotton, 50%% Polyester"); 
re = pthread_create(&thread, NULL, theThread, threadData) ; 
if (rc) { 
printf("Failed to create a %s thread\n", threadData) ; 
exit (EXIT_FAILURE) ; 
} 


threadData = (char *)malloc (THREADDATAMAX) ; 
sprintf (threadData, "Lacquered Camel Hair"); 
re = pthread_create(&thread2, NULL, theThread, threadData) ; 
if (rc) { 
printf("Failed to create a %s thread\n", threadData) ; 
exit (EXIT_FAILURE) ; 
} 


printf("Wait for threads to complete\n"); 
re = pthread_join(thread, NULL); 
if (re) { printf("Failed pthread_join() 1\n"); exit (EXIT_FAILURE); } 


re = pthread_join(thread2, NULL); 
if (re) { printf("Failed pthread_join() 2\n"); exit (EXIT_FAILURE); } 
return 0; 


Job Log Output: 


The following two job log messages where generated by the example shown above. The output was retrieved from 
the spooled file created when the job ran to completion and when the job log was retained. The informational 
messages contain the contents of the Qp0zLprintfQ) function calls. 


Information 
*STMT QPOZCPA 


QpOzVLprintf 


QpOzVLprintf 


Information 
*STMT QPOZCPA 


QpOzVLprintf 


QpOzVLprintf 
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QSYS 


QSYS 


01/05/98 Lo259 05 QPOZCPA 


*STMT 
From module 
From procedure 


Statement 
To module 
To procedure 


Statement Se ee oe ee ES 
THread «© « %« « OOOO0001A 


QPOZUDBG 


296 
QPOZUDBG 


296 


Message ....: 00000000 O000001a: 
Entered the 50% Cotton, 50% Polyester 


thread 


01/05/98 T6259 2:05 QPOZCPA 


*STMT 
From module 
From procedure 


Statement 
To module 
To procedure 


Statement gro cigee el Gr ae ae oe 
Thread «<. «cs « & 0000001B 


QPOZUDBG 


296 
QPOZUDBG 


296 


Message ....: 00000000 OO00001b: 
Entered the Lacquered Camel Hair thread 


Qp0zUprintf()--Print Formatted User Trace Data 


Syntax 


#include <qpO0ztrc.h> 


int QpOzUprintf(char *format-string, ...); 


Service Program Name: QPOZCPA 


Default Public Authority: *USE 


Threadsafe: Yes 


The Qp0zUprintfQ function prints user data specified by the format-string parameter to the user trace. 


If a second parameter, argument-list, is provided, QpO0zUprintf() converts each entry in the argument-list 
and writes the entry to the user trace according to the corresponding format specification in format-string. If 
there are more entries in argument-list than format specifications in format-string, the extra argument-list 
entries are evaluated and then ignored. If there are less entries in argument-list than format specifications in 
format-string, the user trace output for those entries is undefined, and the Qp0zUprintf() function may 
return an error. 


An application should not use the tracing function in performance critical code. These functions are 
intended for debugging exception or error conditions. The user trace is a permanent user space object 
named QPOZ<jobnumber> in the QUSRSYS library. The user trace is created the first time any thread in a 
job writes trace output. See the Change User Trace (CHGUSRTRC), Dump User Trace (DMPUSRTRC) 
and Delete User Trace (DLTUSRTRC) CL commands for information about manipulating the user trace 
properties and objects. 


Parameters 


format-string 


(Input) The format string representing the format of the data to be printed. See the printf() function 


in the ILE C/C++ Programmer's Guide for a description of valid format strings. 


... (argument-list) 


(Input) An optional list of arguments that contain entries to be formatted and printed to the user 
trace. 


Authorities 


None. 


Return Value 
value Qp0zUprintf() was successful. The value returned is the number of characters successfully 
printed. 


-1 Qp0zUprintf() was not successful. The errno variable is set to indicate the error. 


Error Conditions 


If Qp0zUprintfQ is not successful, errno indicates one of the following errors. Under some conditions, 
errno could indicate an error other than those listed here. 


[EINVAL] An invalid parameter was found. 
A parameter passed to this function is not valid. 
An invalid format-string or argument-list was specified. 
[EFAULT] The address used for an argument is not correct. 
In attempting to use an argument in a call, the system detected an address that is not valid. 


While attempting to access a parameter passed to this function, the system detected an 
address that is not valid. 


Usage Notes 


1. No locks are held on the user trace between calls to the tracing functions. The user trace can be 
deleted while in use. The next function that produces trace output will create the user trace again. 


2. If another job on the system has the same job number as an existing user trace, the existing trace 
data is cleared, and the trace data from the new job replaces it. 


3. As the format of the user trace records can change, only the following CL commands can be used 
to manipulate the user trace properties and objects: 


o Change User Trace (CHGUSRTRC) can be used to change the characteristics of the user 
trace. 


o Dump User Trace (DMPUSRTRC) can be used to dump trace records to a file or to 
standard output. 


oO Delete User Trace (DLTUSRTRC) can be used to delete the user trace objects. 


Related Information 
e@ Qp0zDump()--Dump Formatted Storage Trace Data 


e@ Qp0zDumpStack(Q)--Dump Formatted Stack Trace Data 


@ Qp0zDumpTargetStack()--Dump Formatted Stack Trace Data of the Target Thread 


e@ Qp0zLprintfQ--Print Formatted Job Log Data 


Example 


See Qp0zDump(Q)--Dump Formatted Storage Trace Data. 


API introduced: V4R3 


Top | UNIX-Type APIs | APIs by category 


Header Files for UNIX-Type Functions 


Programs using the UNIX-type functions must include one or more header files that contain information 
needed by the functions, such as: 


e Macro definitions 
e Data type definitions 
e Structure definitions 
e Function prototypes 
The header files are provided in the QS YSINC library, which is optionally installable. Make sure 


QSYSINC is on your system before compiling programs that use these header files. For information on 
installing the QSYSINC library, see Data structures and the QSYSINC Library. 


The table below shows the file and member name in the QS YSINC library for each header file used by the 
UNIX-type APIs in this publication. 


Name of File in 
Name of Header File QSYSINC Name of Member 


[| arpa/ineth [| arpa/ineth [ ARPA [INET 


a 
a * 

tik | | so 
[  —sbseerrch CEC A~<“‘i‘~*Y:S*é‘éiBSEERRR 
[ss direnth [CM Rs—~<“i«i‘Cé«zYS)~OCéIRENT 
[ emoh [| H [ERRNO] | 
[_eph | SOS 

| evinttypes. h | | TNS 
ee ee ee 
[| %netinet/iemp6.h NETINE |  ICMP6& 
[| netinetinh NETINET [| WN 
| netinet/ip_icmp.h NETINET [|  IPICMP 


mo) oo) eo) eo) a) ee} ee} ey] 


| netinet/ip.h NETINET | IP 
| 2’netinet/ip6.h NETINET | IP6& 
| netinet/tcp.h NETINET TCP 


| netinet/udp.h NETINET UDP 

[netns/idph = | 0S NETNS) [CIDP 
[netns/ipxh = |S NETNS) [CPX 
[so netns/ns-h | NETNS) [CONST 
[so netns/sp-b |S NETNS) [SP 
[netrouteh = [)CNET)=—~<C;«é‘L”)~Ss*'<‘éROUTEECi:*s 
[—snettel/telLh «= sis[))sSNETTEL =o [)ti‘<‘STENRES—“( isis 


an 


[  oosh fC OS2 

[|  —sosddefh fC ASE S2DEF 
[ pwd fC PWD 

[0 gh fH QLG 

| —s qpOlfloph fs QPOLFLOP 
| Bqp0limih | | QPOLIRNLE 

| 2>qpOlror.h | | QPOLROR& 

|  qpOzolsm-h fC HH—C*ST ss QPOZOLSM 
| — qpOztrech fC QPOZTRE 
|  qpOztrmlh [| CSTs QPOZTRML 
| #qsoasync.h | | QSOASYNC% 
| qtnxaapi.h | QTNXAAPI 
[ qtnxadtph fC H——CSE ss QQTNXADTP 
|  qtomeapih sf] CM ™—C~@TSsC QQOMEEAP 


TRIG 


| qtossapi.h | H | QTOSSAPI 
| resolv.h | H | RESOLVE 


an 


| semaphore.h | | SEMAPHORE 


[signal | CMHC SIGNAL 
[|  spawnh Cf CM ™~“<~S SPAWN 
[ssh fA SSL 

| sysferrnoh = fC H™:~iT SC ERRNOU 
[| sysfioctLh SYS [|  IOCTL 
| ——ssys/ipeh SYS [ woe 


| sys/layout.h | H | LAYOUT 
| sys/limits.h | H | LIMITS 


| —ssys/msg-ho SYS MSG 

[| sys/param.h SYS [ PARAM 
| #*sys/resource.h SYS | RESOURCE® 

| —ssys/sem-h SYS SEM 

| sys/setimp.h SYS | ‘SETIMP 
| sys/shm.h SYS SHM 

[| sys/signalh SYS [ SIGNAL 
[| _sys/socketh SYS [SOCKET 
[| —sys/stath SYS [ STAT” 


| sys/statvfs.h SYS | STATVFS 


| —ssysfimeh SYS [| TIME 
[| sys/types.b SYS [TYPES si 
| —ssys/uio.h SYS UIO 

[ sys SYS [ UN 
| —ssys/waith SYS | WAIT 
| Sulimit.h H | ULIMIT*& 

[| sounistdh fC HSE UNISTD 
[  soutimeh fC UTIME 


You can display a header file in QS YSINC by using one of the following methods: 


e Using your editor. For example, to display the unistd.h header file using the Source Entry Utility 
editor, enter the following command: 


STRSEU SRCFILE(QSYSINC/H) SRCMBR(UNISTD) OPTION(5) 


e Using the Display Physical File Member command. For example, to display the sys/stat.h header 
file, enter the following command: 


DSPPFM FILE(QSYSINC/SYS) MBR(STAT) 


You can print a header file in QSYSINC by using one of the following methods: 


e Using your editor. For example, to print the unistd.h header file using the Source Entry Utility 
editor, enter the following command: 


STRSEU SRCFILE(QSYSINC/H) SRCMBR(UNISTD) OPTION (6) 
e Using the Copy File command. For example, to print the sys/stat.h header file, enter the following 


command: 


CPYF FROMFILE(QSYSINC/SYS) TOFILE(*PRINT) FROMMBR (STAT) 


Symbolic links to these header files are also provided in directory /QIBM/include. 


Top | UNIX-Type APIs | APIs by category 


Errno Values for UNIX-Type Functions 


Programs using the UNIX-type functions may receive error information as errno values. The possible 
values returned are listed here in ascending errno value sequence. 


[Name [Value [Test 

~——— a ee domain error occurred in a math 
function. 

[ERANGE = GE [300200 A [Arangeerror occurred. = error [Arangeerror occurred. = 

—| C _— Data was truncated on an input, output, or 
update operation. 

EN [ENOTOPEN [3004 [Fileisnotopen. is not [Fileisnotopen. 


—— OTREAD — [File i is not opened for read operations. 
EIO [3006 [Input/output error. 


EN [ENODEV [3007 N [Nosuchdevice. [Nosuchdevice. device. 

ae —_ Cannot get single character for files 
opened for record I/O. 

EN [ENOTWRITE [30090 [File is not opened for write operations. is not [File is not opened for write operations. for write operations. 


a —— [The stdin stream cannot be opened. 
[ESTDOUT [3011 [The stdout stream cannot be opened. 


[ESTDERR [30120 [The stderr stream cannot be opened. stderr stream cannot be [The stderr stream cannot be opened. 

_—| a The positioning parameter in fseek is not 
correct. 

[EBADNAME AME [30140 [The object name specified is not correct. — [The object name specified is not correct. — name specified is not correct. 


a ——! The type variable specified on the open 
function is not correct. 


[EBADPOS 3017s [The position specifier is not correct. position [The position specifier is not correct. is not correct. 


17 
EN a — There is no record at the specified 
position. 
ENUMMBRS 3019 Attempted to use ftell on multiple 
members. 
ENUMRECS 3020 The current record position is too long for 
ftell. 
EINVAL 3021 The value specified for the argument is not 
correct. 
EBADFUNC 3022 Function parameter in the signal function 
is not set. 
[302500 


EN [ENOENT T No [No such path or directory, = [No such path or directory, = or directory. 


FoR? ——— ht’ —— ae 
[EPERM  =——<CS~s«LB27_~——SSC«*d Phe Oplerationn is not permitted. = 
[EBADDATA  ——s[3028——Ss[Meessage dataisnotvalid. = 
[EBUSY ==—=«S(38029—s Resource busy, 
[EBADOPT —s*(3040 = Option specified is not valid. 
[ENOTUPD ~—s*([3041 =~‘ File is not opened for update operations. 
[ENOTDLT ~—*[3042. [File is not opened for delete operations. 


EPAD 3043 The number of characters written is 
shorter than the expected record length. 

EBADKEYLN 3044 A length that was not valid was specified 
for the key. 

EPUTANDGET 3080 A read operation should not immediately 
follow a write operation. 

EGETANDPUT 3081 A write operation should not immediately 
follow a read operation. 

[EIOERROR [3101 [A nonrecoverable I/O error occurred. 

[EIORECERR [3 102 [A recoverable I/O error occurred. 

[EACCES [3401 [Permission denied. 


[EN OTDIR [3403 [N ot a directory. 
[ENOSPC [3404 [No space is available. 


[EXDEV [3405 Improper link, [Improperlink, 


[34050 
aa_— 3406 Operation would have caused the process 
to be suspended. 
EWOULDBLOCK 3406 Operation would have caused the process 
to be suspended. 
[3407 


[EINTR [3407 SS s‘[Interrupted function call. [Interrupted function call. call. 


ee— 3408 The address used for an argument was not 
correct. 


[ETIME [3409 [3409 [Operation timedout. [Operation timedout. out. 
—_——— [3415 0 No [No such device oraddress. device [No such device oraddress. address. 
SEs i Pa 
failure 
[ERECURSE [3419 [Recursive attempt rejected. = attempt [Recursive attempt rejected. = 
 ORNESE Si —— see 
[EADDRNOTAVAIL [342200 [Address is notavailable. = [Address is notavailable. = not available. 
ESINOSUORT > pean type of socket is not supported in this 
protocol family. 
[EALREADY [342300 [3423 [Operation is already in progress. = is already in progress. 
REE ABORTED [34240000 [Connection ended abnormally. ended [Connection ended abnormally. 
25 


ECONNRTUSED — aS rma ba tn te 
connect operation 
i ae ce 
reset by that socket 
[EDESTADDRREQ. [3427 00 [3427 | Operation requires destination address. requires [Operation requires destination address. address. 
[EHOSTDOWN [3428s {Ar remote host is notavailable. 
[EHOSTUNREACH [3429 ‘A route to the remote host is not available. 
[EINPROGRESS —[3430. Ss |Operationin progress. = 
[EISCONN «(3431s {A connection has already been established. 
[EMSGSIZE «(3432s [Message size isoutofrange. 
[ENETDOWN  ——s[3433.—s*[ The network currently is not available. 


ENETRESET 3434 A socket is connected to a host that is no 
longer available. 


[ENETUN REACH [3435 [Cannot reach the destination network. 

ENOBUFS 3436 There is not enough buffer space for the 
requested operation. 

ENOPROTOOPT 3437 The protocol does not support the 

specified option. 

ENOTCONN 3438 Requested operation requires a 
connection. 

ENOTSOCK 3439 The specified descriptor does not 
reference a socket. 

[EN OTSUP [3440 [Operation is not supported. 

[EOPN OTSUPP [3440 [Operation is not supported. 


EPFNOSUPPORT 3441 The socket protocol family is not 
supported. 

EPROTONOSUPPORT |3442 No protocol of the specified type and 
domain exists. 

EPROTOTYPE 3443 The socket type or protocols are not 
compatible. 

ERCVDERR 3444 An error indication was sent by the peer 
program. 


[ESHUTDOWN [3445 [Cannot send data after a shutdown. 
[ESOCKTN OSUPPORT [3446 [The specified socket type is not supported. 


ETIMEDOUT 3447 A remote host did not respond within the 
timeout period. 

EUNATCH 3448 The protocol required to support the 
specified address family is not available at 
this time. 


[EBADF = =—S—=«&;3'45——SsDescriptorisnot valid, 
[EMFILE  =—S*[3452,—S——Ss {Too many open files for this process. 
[ENFILE =——=S&3453. Ss [Too many open files inthe system. 
EPIPE == ~—«*(3455, ss (Brokenpipe. 
[ECANCEL =——s«[3456.———s|Operationcancelled. = 
[EEXIST =———s«*(3'KST_—— sie exists, 
[EDEADLK =——s*[3459_ Resource deadlock avoided. 
[ENOMEM ——s«[3460—Ss« Storage allocation request failed. = 
62 


a 34 The synchronization object no longer 
exists because the owner is no longer 
running. 

EDESTROYED 3463 The synchronization object was destroyed, 
or the object no longer exists. 

[ETERM [3464 00—CO [3464 Operation was terminated. = was [Operation was terminated. = 


aes —— OENT1 [3 465 [N o such file or directory. 


ENOEQFLOG 3466 Object is already linked to a dead 
ones sag 


[EEMPTYDIR [3 467 [Directoryisempty. = is empty. 


EMLINK 3468 Maximum link count for a file was 
exceeded. 


ESPIPE  =—~SC~«&346—— “Seek request is not supported for object. 
[ENOSYS —————=«*3470.—S—SSs|Function not implemented. = 
[EISDIR ——i(ass—t*é«*BATALC Specified targetisadirectory, = 
[EROFS =———~—é«i;3B220-—— Read-only file system. 
[EUNKNOWN  —s[3474.— ss [Unknown system state. = 
[EITERBAD  =——s«(34750—— iterator isnotvalid. = 
[EITERSTE  =—sS*(3476 ~—S—SCs=|Iterator is in wrong state for operation. 
[EHRICLSBAD —s [3477 Ss HIRI classisnotvalid. 
[EHRICLBAD ~—s([3478 = {IRI subclassisnot valid. = 
[EHRITYPBAD —[3479 Ss {HRI typeisnotvalid, = 
[ENOTAPPL —=—s*[3480.—~——Ss [Datta requested is not applicable. = 
[EHRIREQTYP  =—[3481_ = {ARI request type isnot valid. 
[EHRINAMEBAD —_ [3482s {HRT resource name isnot valid. 
[EDAMAGE —s([3484.————s [A damaged object was encountered. 
[ELOOP  ———~™—=é«S;3485— SA cop exists in the symbolic links. 
[ENAMETOOLONG [3486 = {Apathnameistoolong, 
[ENOLCK = =——s«*(3487,——s No locksare available. = 
[ENOTEMPTY —*[3488 ~=——Ss[Directory isnotempty. = 
[ENOSYSRSC [3489s System resources are not available. = 
[ECONVERT =— [3490s |Conversionerror, 


[E2BIG [3491 [3491 Ss [Argumentlististoolong, [Argument lististoolong, = is too long. 
—=———— 3492 Conversion stopped due to input character 
that does not belong to the input codeset. 


[ETYPE  ——™ [3493 [3493 |Objecttypemismatche type [Object type mismatch, 
—— 3494 Attempted to reference a directory that 
was not found or was destroyed. 
EBADOBJ 3495 Attempted to reference an object that was 
not found, was destroyed, or was 
damaged. 
EIDXINVAL 3496 Data space index used as a directory is not 
valid. 
[ESOFTDAMAGE [3497 [3497 [Objecthas softdamage. [Objecthas softdamage. soft damage. 


Soe | OTENROLL 3498 User is not enrolled in system distribution 
ies sae———— 


[EOFFLINE = 3499 [3499 |Objectissuspended. is suspended. 


[34990 
oe —— [3 500 [Object i is a read-only object. 


EEAHDDSI 3501 Hard damage on extended attribute data 
space index. 

EEASDDSI 3502 Soft damage on extended attribute data 
space index. 

EEAHDDS 3503 Hard damage on extended attribute data 
space. 

EEASDDS 3504 Soft damage on extended attribute data 

| | ee 


[EEADUPRC [3505 [Duplicate extended attribute record. 


ELOCKED 3506 Area being read from or written to is 
locked. 


[EFBIG [3507 [3507 ss |Objecttoolarge. [Objecttoolarge, large. 
509 


a—_—— 3 The semaphore, shared memory, or 
message queue identifier is removed from 
the system. 

OMSG e The queue does not contain a message of 


the desired type and (msgflg logically 
ANDed with IPC_NOWAIT). 


[EFILECVT = [351k [File ID conversion of a directory failed. ID conversion of a [File ID conversion of a directory failed. failed. 

a——— _— A file ID could not be assigned when 
linking an object to a directory. 

[ESTALE [3513 [File handle was rejected by server. handle was [File handle was rejected by server. by server. 


es} — oes 
[ENOTSIGINIT ——[3516 [Process is not enabled for signals. 

[ECHILD  =———~—=«~S(;B'SS'T.— Ss Nochild process. 
[EBADH = =—sS«(3520.——sHandleisnotvalid, = 


iN YREFS 3523 The operation would have exceeded the 


maximum number of references allowed 
for a descriptor. 


[ENOTSAFE =——s [3524s |Functionisnotallowed. = 
ESC aW—— sk —— pice ee ——— 
[EIRNDAMAGE ~—[3526 Ss |Jourmalisdamaged. 
[EJRNINACTIVE ~— [3527s |Jourmalisimactive, = 
[EIRNRCVSPC [3528 = s‘|Journal space or system storage error. 
[EIRNRMT = ——s*(3529, Ss Journalisremote. 
[ENEWJRNRCV [3530s [New journal receiver isneeded. 
[ENEWJRN  ———s«(3531.=——Ss New journalisneeded. = 
[EJOURNALED [3532s Objectalready journaled. = 
[EIRNENTTOOLONG 3533 [Entry istoolargetosend. 
[EDATALINK —s [3534s [Object is adatalink object. 
[ENOTAVAIL ~—s 3535. IASPisnotavailable. = 


[ENOTTY = OTTY [35360 [I/O control operation is not appropriate. control [I/O control operation is not appropriate. is not appropriate. 

sues 3540 Attempt to write or truncate file past its 
=o ie file size limit. 

[ETXTBSY [35430 [Textfilebusy. file [Textfilebusy. 

SENG OTSET ~— [ASP group not set forthread. [ASP group not set forthread. not set for thread. 


—— a A system call was interrupted and may be 
restarted. 
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